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Preface 



This manual describes ALLY release 2.0. 



This guide provides information about how to install ALLY on 
Unisys System V UNIX operating systems for U Series comput- 
ers. 

This guide has five appendixes. The first appendix contains the 
correct set-up values for the SVT-1220 and UVT-1224 terminals. 
The remaining four appendixes contain information about confi- 
guring specific systems. 



Audience 



This guide is written for the person who installs ALLY on the 
computer system, such as a systems analyst, site administrator, or 
data processing manager. The installer should understand the 
UNIX operating system and other software applications already 
installed on the system. 



Prerequisites 



We assume that you have a thorough knowledge of UNIX com- 
mands and syntax. If you are installing the ALLY Development 
System, you can refer to the ALLY System Manager's Guide 
(UP- 13765) and the access method developer notes. Refer to 
other documentation for your computer system and terminals as 
needed. 
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The ALLY Documentation—What to Read 



The following illustration shows you how the ALLY documenta- 
tion is organized. 

[f you want to develop ALLY applications, we suggest that you 
start by reading the ALLY system's introductory brochure. Intro- 
duction to ALLY. Then, you can build the application in Building 
a Simple Application. 

If you want to install ALLY, you should read the installation 
guide for your system. 

Note that the documentation for the runtime system of ALLY 
includes only the installation guide for your system, ALLY Com- 
mand Reference Manual, and AMU User's Guide. 



Introductory 
reading: 



Introduction 

to ALLY 
(UP-12500) 



Building a 
Simple 
Application 
(UP-12S01) 



Installing 
ALLY: 



Installation 
Guide 



System 
Manager's 

Guide 
(UP-13765) 



Managing 
Applications 



Read. 
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Conventions 



You should read carefully the description of documentation con- 
ventions before reading this manual. 

We use the following conventions in this manual: 



Single quotes (* ') 
Boldface type (bold) 

Double quotes (" ") 



Brackets (<x>) 



Empty brackets (<>) 



Identify command names. 

Highlights text you are to enter. Boldface 
is also used within command syntax state- 
ments. 

Identify text strings within text sections. 
These strings are typically located in 
examples or as part of the prompts that 
ALLY sends to your display. 

Sometimes the exact content of a text 
string is affected by the traditional rules 
of punctuation. In these cases, we place 
the closing quotation mark at the end of 
the text string. For example, instead of: 

You see the prompt "Macro number:." 

We say: 

You see the prompt "Macro number:". 

Enclose a specific. key (x = key) to be 
typed. Angle brackets are used in com- 
mand syntax and key assignment lines. 
For example: 

<,> the "comma" key on the 

numeric keypad 
<Return> the "Return" key 
<Do> the "Do" key 
<F18> the "function" key 18 
<2> the "2" on the numeric 

keypad 

Represent a form that requires input in 
menu path sequences, e.g., 1 2 <> 3 4. 
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Space (<Space>) Represents a blank to be entered. A 

<Space> request asks you to type the 
space bar once. 

Square brackets ([]) Enclose an argument for the command- 
line invocation of a utility. For example, 
newprint [printer name] [output file]. 

The key-definition files that are supplied with ALLY assign keys 
to several commands. For convenience, we assume that the fol- 
lowing ALLY commands are assigned as shown. 



Command 


Key Assignment 


"add new line' 


< Return > 


'up' 


< t> 


'down' 


< |> 


'right' 


<-*> 


Meff 


<<-> 


'define macro' 


(See template) 



The < t>, < i>, <~*>, and <•*-> key assignments typically 
use a terminal's cursor-control keys. 

End of Preface 
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This document contains instructions for installing ALLY and 
establishing ALLY'S working environment on Unisys System V 
UNIX operating systems for the following U Series computers: 

• U7000/30,40,50,51,52 

• U6000/50 

• U5000/85,90,95 

• U5000/30,35,50,55 

Your tape is labeled with the system type. 

ALLY supports several different access methods, including 
C-ISAM, ORACLE, and UNIFY. Table 1 lists the access- 
method release levels that are valid for use with ALLY 2.0. 

Table 1 . Supported Access-Method Release Levels 



Access Method 



Release Level 



C-ISAM 



3.1 



ORACLE 



5.1.17.4 



UNIFY 



4.0 
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Installation Overview 



The installation process is divided into three major steps: 

1) Installing ALLY with the Unisys Menu System. Refer to 
the Menu System Guide (UP- 11763) for information 
about the menu system. 

2) Establishing the ALLY working environment, which 
includes: 

• Checking the default maximum size of the file- 
locking table. Information about how to increase 
the maximum size of the file-locking table is 
system-specific and is provided in Appendixes B, 
C, D, and E. 

• Checking ALLY environment variable values and 
setting them if necessary. 

For more information about environment vari- 
ables, see the ALLY System Manager's Guide 
(UP- 13765), or call your ALLY distributer. 

• Checking access-method dependencies and setting 
their associated variables if necessary. For further 
information about access-method dependencies, 
see the developer notes for your access method, or 
call your ALLY distributer. 

• Checking that the search path is correctly set. 

3) Verifying that the ALLY installation is successful. 

The next sections list requirements for installing ALLY and 
describe the installation procedure. The last section in this docu- 
ment is a trouble-shooting guide to help you determine why an 
installation does not verify, or why an application does not exe- 
cute successfully. 

We recommend that you read all of the instructions that are appli- 
cable to your site before you begin the installation procedure. 
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Release Requirements 



Before starting the ALLY installation procedure, you must have: 

• a unique group for the ALLY account with the group name 
"ally," in lowercase letters. 

• a unique user account for ALLY. The user login name 
must be "ally," in lowercase letters. 

• enough space in the ALLY account file system. (The disk 
space requirements are listed in the following section.) 

• a terminal that communicates with ALLY. Appendix A 
contains information about how to set the SVT-1220 and 
UVT-1224 terminals. 

If this is your first ALLY release, you need to set up the ALLY 
group and user account. If you have installed a previous ALLY 
release, you already have an ALLY group and user account. 

Disk Space Requirements 



ALLY 2.0 requires approximately nine megabytes of disk space 
for the development system and three megabytes for the runtime 
system. 



Memory Allocation 



The amount of memory required to load an ALLY executable 
image is the sum of the bytes in the shared text segment and in 
the nonshared data segments, as shown in Figure 1. The com- 
bined text and data segment for each user is the user process 
space. The text segment contains the executable machine instruc- 
tions. Data segments contain the initialized and uninitialized data 
for the executable image. 
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User #1 



Text Segment 



Initialized Data 



Bss Segment 



VM Buffer 



Runtime Data 



User #2 



Text Segment 



Data Segment 



F002-0585-00 



Figure 1. Memory Allocation 



Once ALLY'S text segment is loaded into memory, it is shared by 
all users. This means that all users can execute ALLY with only 
one copy of each executable image in memory. 

The data segment is local for each user (i.e., not shared by other 
users). A part of the data segment is the bss segment, which con- 
tains uninitialized data for the executable image. 



NOTE: To run ALLY on the U5000/30,35 or U5000/50,55 
requires a user process space of at least two megabytes and 
preferably four megabytes. 

See Appendix E, "Configuring the U5000/30,35,50,55," for 
information about how to increase the maximum process- 
memory space. 
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Minimum Memory 



The minimum memory required to run ALLY is the executable 
image's total size plus ALLY'S memory management buffers. 
The formula to calculate the executable image's total size is: 

fexr segment 
+ data segment (initialized) 
+ bss segment (uninitialized data) 

For one ALLY user to invoke the Application Developer's Dialog 
requires one megabyte of memory. Each additional ALLY user 
requires about one fifth of a megabyte to invoke the Dialog. 



ALLY'S Memory Management Buffers 



Each ALLY memory buffer is the equivalent of 5 1 2 bytes of 
memory. The number of memory buffers assigned to ALLY 
affects the read and write operations for AFlLEs, external symbol 
table files, FX files, and ALLY temporary work files. In general, 
the more ALLY memory buffers assigned, the less often data has 
to be written to and read from disks. 

The AFILE defines the initial memory request, which allocates 
the number of ALLY internal memory management buffers, 
called virtual memory buffers. Subsequent memory requests 
made during the application's execution expand an ALLY user's 
data segment. 



Memory and ALLY'S Memory Buffers 

To calculate the exact amount of physical memory required to run 
an ALLY application, add the executable image's total size to the 
number of memory management buffers multiplied by the number 
of bytes per buffer (number of buffers x 512). The formula to 
calculate the executable image's total size is given in the 
"Minimum Memory" section. 
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Table 2 shows the number of ALLY memory management buffers 
assigned to run the listed AFILEs. 

Table 2. ALLY Memory Management Buffer Allocation 



To Run Plan On 



The Dialog 300 memory buffers 

The AMU 300 memory buffers 

Application AFILEs 300 memory buffers 



Step 1 : Installing ALLY 



This section describes how to install ALLY with the Unisys Menu 
System. Commands that you are to type on your keyboard are 
shown in boldface print. Type the text exactly as shown and ter- 
minate commands by typing < Return >. Do not type the angle 
brackets — they simply indicate a key. 

1) Mount the ALLY installation tape onto the tape drive. 
(Mount the tape onto drive zero if you have more than 
one drive.) 

2) Log-in to the Unisys menu system and follow the menu 
system's software installation instructions. (You will 
select these choices: System Management, Install, and 
Software Product.) 

The menu system prints several status messages on your 
terminal. Then, the ALLY installation command file 
verifies that the proper account and group exist. 
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If the ALLY installation command file cannot find the 
proper account or group, it: 

• displays an error message 

• terminates the installation process 

• returns you to the menu system 

If the account and group are appropriate, the following 
messages are displayed on your terminal: 



Verifying ally account 
CK 

Verifying ally group 



ALLY will be installed in "directory path" 

Type "Y<teturn>" to continue the installation process or "IWteturn>" 
to terminate the installation process and return to the menu system. 



Comment: The words "directory path" are replaced by 
the path assigned to the ALLY login direc- 
tory. 

3) If you have previously installed any version of ALLY, 
the installation procedure displays the following: 

Response: Do you want to remove a\\yx_yz? 

Type: Y<Return> to remove the other ALLY 



CK 



release, or 



N<Return> to preserve an earlier ALLY 
release. 



Comment: 



Each release is stored in a subdirectory 
named "ally.r_vz," where x_yz is the release 
number. You do not need to remove the 
directory containing the other ALLY release. 



Response: 



Removing ally.r_yz. Please wait... 
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4) When the installation process is complete, the following 
message is displayed: 



ALLY Installafclm is ccnplebe. 

Before you use ALLY, you nusb establish the appropriate IKDC search path and 
envixTxmsxb variables as described in the "Step 2: Establishing the ALLY 
Enviixxmsnt" swctAra of the ALLY Installation Guide. 



You are then returned to the menu system, from which 
you can log-out. 

5) Read the "Step 2: Establishing the ALLY Environment" 
section that follows for information about how to set the 
appropriate search path and environment variables. 

Step 2: Establishing 
the ALLY Environment 



This section briefly describes the following aspects of establishing 
the ALLY environment on UNIX systems: 

• maximum size of the file-locking table 

• ALLY environment variables 

• access-method dependencies 

• search path to the ALLY directory 



File-Locking Table 



ALLY locks application AFILEs and at least six ALLY system 
files for each user. In addition, some access methods (e.g., 
C-ISAM) protect their file system with file locks. On some sys- 
tems, the file-locking table may not be large enough to support 
multiple ALLY users. Depending on the number of users and the 
type of system at your site, you may need to increase the default 
maximum size of the UNLX file-locking table. 
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Each file lock is an entry in the file-locking table. The number of 
table entries is the "size" of the file-locking table. As shown in 
Table 3, the default maximum size of the file-locking table varies 
by machine. 

Table 3. Default File-Locking Table Size 



Unisys Computer 


Operating 
System Release 


Default 
Table Size 


117000/30,40,50,51,52 


1R1, 1R2, 2.20.01 


100 


U6000/50 


2.00.10.10 


100 


U5000/85,90,95 


1R1, 2R1, 3R1, 4.0 


30 


U5000/30,35,50,55 


1R1, 1R1A, 2R1, 1.03.xx 


200 



Calculating the File-Locking Table Size 



To determine the appropriate maximum file-locking table size for 
your site, assume that each user needs to be able to lock twenty- 
five files. This is more than ample and provides a margin of 
safety. Multiply the number of file locks per user by the number 
of anticipated users to obtain the maximum number of file locks 
needed. If the number of file locks needed exceeds the default 
maximum table size (Table 3), you need to increase the table size. 

See the appropriate appendix for your system for information 
about how to increase the default maximum size of the file- 
locking table. 

• Appendix B For the U7000 series 

• Appendix C For the U6000/50 

• Appendix D For the U5000/85,90,95 

• Appendix E For the U5000/30,35 and U5000/50,55 
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ALLY Environment Variables 



Environment variables specify runtime information, such as paths 
to files. When an application executes, ALLY looks for the 
values of environment variables in the operating system's list of 
environment variable definitions. 

Table 4 describes four operating-system environment variables 
that ALLY uses. 



Table 4. ALLY Environment Variables 



Variable 


Value 


Required? 


ally 


The path to the top-level ALLY 
directory 


Yes 


path 


The path to the subdirectory that 
contains ALLY'S command files 


Yes 


TERM 


The name of a terminal type 
(e.g., svtl22() for the SVT-1220) 


Yes 


allyprinter 


Overrides the default printer spooling 
device or queue name for ALLY output 


No 



You can use the following command to determine whether an 
environment variable is defined: 

echo $variable_name 



Required environment variables must be set for each ALLY-user 
process. 
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"ally" Environment Variable 



The value of the "ally" environment variable is the path to the 
ALLY release subdirectory in the ALLY login directory. The 
"ally" environment variable is used by: 

• ALLY to construct file names for library AFILEs and util- 
ity files (e.g., the terminal definition file, printer definition 
file, and Format File) 

• users to invoke ALLY from their working directories 
C shell users can use this command to set the "ally" variable: 

setenv ally ~ally/allyx_yz 

Bourne shell users can use these commands to set the "ally" vari- 
able: 

ally=A7ome directory la\\yx_yz 
export ally 



"path" Environment Variable 

The value of the "path" environment variable is the sequence of 
directories to search for ALLY command files that invoke ALLY 
and its utilities. C shell users can use this command to set the 
"path" variable: 

set path=($path Sally/bin) 

Bourne shell users can use these commands to set the "path" vari- 
able: 

PATH= :$PATH:$ally/bin: 
export PATH 
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"TERM" Environment Variable 



ALLY needs a terminal description file for each type of terminal 
used with interactive ALLY sessions. The Terminal Definer util- 
ity produces the terminal description file, which tells ALLY what 
action to take when a key is typed. ALLY command files append 
a "c" to the value of the "TERM" variable and look for a termi- 
nal description file with this name. 

You can override the "TERM" variable setting by specifying a 
different terminal description file as an argument to an ALLY 
invocation command. ALLY cannot run if it cannot find the ter- 
minal description file. 

C shell users can use this command to set the "TERM" variable: 
setenv TERM terminaljype 

Bourne shell users can use these commands to set the "TERM" 
variable: 

TERM = terminaljype 
export TERM 



"ally printer" Environment Variable 



The environment variable "allyprinter" is not required to be set. 
However, it can be set to either "copy" or "none." 

C shell users can use either of these two commands to set the 
"allyprinter" variable: 

setenv allyprinter copy 

or 

setenv allyprinter none 



12 



UP-14221 



ALLY Installation Guide 



Bourne shell users can use either of these pairs of commands to 
set the "allyprinter" variable: 

allyprinter=copy 
export allyprinter 

or 

allyprinter = none 
export allyprinter 

See the System Manager's Guide for more information about 
ALLY environment variables. 



Access-Method Dependencies 



In addition to the environment variables described in the previous 
section, some access methods require you to set environment vari- 
ables. Dependencies for ORACLE and UNIFY are described in 
the next two sections. If you are using another access method, 
you can skip these sections and continue with the "Search Path" 
section. 



ORACLE Environment Variables 



There are two ORACLE environment variables that must be set 
for ALLY to access ORACLE tables: ORACLE.HOME and 
ORACLE.SID. 



OR A CLEJHOME 



ORACLE_HOME identifies the home directory containing the 
ORACLE product files. If you do not assign a home directory, 
ORACLE is assumed to be installed in the default directory 
named "/usr/oracle." C shell users can use the following com- 
mand to set this environment variable: 

setenv ORACLE_HOME oracle _directory_name 
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Bourne shell users can use the following commands to set 
ORACLE.HOME: 

OR ACLE.HOME = oracle _directory_name 
export ORACLE.HOME 



ORACLE_SID 



ORACLE.SID is the ORACLE System Identifier that identifies a 
database. If you are using ORACLE'S default production system, 
the ORACLE_SID number should be set to null. Use two double 
quotation marks ("") to indicate a null value (for example, 
ORACLE.SID^'"). Each additional database system should 
have a unique letter for its ORACLE_SID. 

C shell users can use the following command to set this environ- 
ment variable to a null value: 

setenv ORACLE.SID 

Bourne shell users can use the following commands to set 
ORACLE_SID to null: 

ORACLE_SID= "" 
export ORACLE.SID 

If you have many ALLY users that access ORACLE tables, you 
may receive error messages indicating insufficient enqueues or 
open cursors. In this case, you may need to increase two parame- 
ter settings when the ORACLE database is initialized. See the 
"Trouble Shooting" section for more information. 

UNIFY Environment Variables 



There are two UNIFY environment variables that you may need 
to set. You need to set the "DBPATH" environment variable if 
your UNIFY files are not in the directory from which you execute 
ALLY. The value of "DBPATH" is the directory that contains 
your UNIFY files. You need to set the "DBNAME" environ- 
ment variable if your UNIFY database file has a name that is not 
the default name (file.db). 
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These two UNIFY environment variables, DBPATH and 
DBNAME, can be set from your operating system shell. 

If you are using the C shell, use the following syntax when setting 
these environment variables: 

setenv [variable_name] [value] 

If you are using the Bourne shell, use the following syntax: 

variable_name= value 
export variable_name 

See the UNIFY Developer Notes (UP-12969) for more information 
about accessing a UNIFY database with ALLY. 



Search Path 



The ALLY installation procedure creates ".cshrc" and ".profile" 
files in the ALLY account's home directory. These files contain 
the commands that set the environment variables and the search 
path for invoking ALLY. The search path points to the directory 
that contains UNIX command files (scripts) that invoke ALLY 
and the ALLY utilities. See Appendix F for the contents of the 
".cshrc" and ".profile" files. 

Each ALLY-user process must use these environment variables 
and search path. C shell users can add this statement to their own 
".cshrc" file: 

source -ally/.cshrc 

A C shell user's ".login" file may execute after the ".cshrc" file. 
Therefore, the ".login" file should not contain path definitions 
that conflict with those in the ".cshrc" file. 

Bourne shell users can add the following statement to their own 
".profile" file: 

. allyJogin_directory_path/.prof\\e 
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Step 3: Verifying the Installation 



The next two sections describe how to verify that the ALLY 
installation is successful, and that users can access the error and 
help library AFILEs. Verification is accomplished by running an 
AFILE on both the Runtime System and the Development Sys- 
tem. Follow the testing procedure for both systems if you are 
installing the Development System. 



Verifying on the Runtime System 



The command shown below runs an application named 
"HOURS.A" on the Runtime System. (The -HOURS.A" 
AF[LE is included on the installation tape.) 

ally Sally/afiles/storybook/HOURS.A 

1) From the application's main menu, select choice number 
6 (a nonexistent choice). The path to the error AFILE 
has been established if the following message is displayed 
on the bottom of the menu: 



You selected a <-*y»<~ that. Is nob valid far this oenu. 



2) Next, while the error message is displayed, type the 
"Do" key to access the ALLY Command Menus. Select 
choice 1 and then press the key assigned to "help." The 
path to the help AFILE has been established if help 
information for task and action control commands is 
displayed on your screen. 

3) Type <Return> three times to return to the Dialog's 
main menu (once to exit from the help facility, once to 
exit from the Command Menus, and once to exit from 
the error message). Now select the exit choice from the 
main menu to return to the operating system. 

If the appropriate error and help messages are not displayed, read 
the "Trouble Shooting" section at the end of this guide. 
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Verifying on the Development System 



Type the following command to invoke the Application 
Developer's Dialog: 

dialog 

Once you have invoked the Dialog, follow these steps: 

1) When prompted, type the name of any new AFILE 
(e.g., TEST. A). This creates a new AFILE ••skeleton," 
called a trunk AFILE, which you can delete after you 
verify the installation. 

2) From the Dialog's main menu, select choice number 10 
(a nonexistent choice). The path to the error AFILE has 
been established if the following message is displaced on 
the bottom of the menu: 



You selected a choice that 1b not valid far this menu. 



3) Next, while the error message is displayed, type the 
"Do" key to access the ALLY Command Menus. Select 
choice 1 and then press the key assigned to ••help." The 
path to the help AFILE has been established if help 
information for task and action control commands is 
displayed on your screen. 

4) Type <Return> three times to return to the Dialog's 
main menu (once to exit from, the help facility, once to 
exit from the Command Menus, and once to exit from 
the error message). Now select the exit choice from the 
Dialog's main menu to return to the operating system. 

If the appropriate error and help messages are not displayed, read 
the "Trouble Shooting" section that follows. 
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Trouble Shooting 



This section describes some conditions that can prevent an instal- 
lation from verifying or an application from executing as 
expected. 

Terminai Configuration Problems 



ALLY command files append a "c" to the value of the "TERM" 
variable and look for a terminal description file with this name. 
You receive an error message indicating that ALLY cannot open 
the terminal description file if either the "TERM" variable is not 
set or the specified file cannot be found: 



You hare specified the name af a file that, is nofc a valid terminal descripticri 
file. 



If your terminal does not behave as expected, that is, if the com- 
mands you want do not execute when you type the keys, you do 
not have a terminal description file that matches your terminal 
type. 



Type: <Esc> <t> <a> <p> 



Comment: If your keyboard does not have an "Escape" key 

(<Esc>) type the "Control" key (<Ctrl>) and the 
"left square-bracket" (<[>) key to send the octal 
code for "escape." In this case, you would type the 
following key sequence: 

<Ctrl><[xtxa><p> 
Response: Exit from ALLY. 
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Once you have exited from ALLY, use the following command to 
see whether the value of the "TERM" variable matches your ter- 
minal type: 

echo STERM 

Set the "TERM" variable to your terminal type if it is not already 
set or is set incorrectly. If the "TERM" variable is correctly set, 
and you still experience problems with your terminal. Appendix A 
shows the proper Terminal Set-Up values for SVT-1220 and 
UVT-1224 terminals. 



Installation Verification Problems 



If you receive an error message stating that ALLY cannot access 
the help AFILE or the error AFILE, check that the "ally" 
environment variable is set to the ALLY account home directory 
and release subdirectory, as shown below: 

ally/ally2_00 

If you cannot execute ALLY command files (you receive an error 
message that says ALLY cannot access the specified file or direc- 
tory), check that the "path" environment variable includes the 
following ALLY directories: 

ally/ally2_00/bin 
Other ALLY Installation-Related Problems 

Depending on your system and the number of ALLY users at 
your site, you may need to increase the default maximum file- 
locking table size. If the number of file locks available is not suf- 
ficient, you will receive an error message stating that the specified 
file cannot be opened. The file could be a terminal file or any 
AFILE, including help and error message AFELEs. 
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ORACLE Problems 



If you have many ALLY users accessing ORACLE tables, you 
may receive error messages indicating an insufficient number of 
enqueues and/or open cursors. In this case, you need to increase 
the settings of two parameters when you initialize the ORACLE 
database: 

enqueues specifies the maximum number of total enqueue 
entries. The default value is 125, which is five 
times the number of default ORACLE processes. 
Each database cursor requires one enqueue for 
each table accessed or updated, and each row 
locked. 

open_cursors specifies the maximum number of cursors that each 
user is allowed to open. An open cursor is needed 
for each insert, update, delete, and select state- 
ment from a DSD. The value of open_cursors can 
be any number from 10 to 255; the default value is 
50. 

Refer to your ORACLE documentation, particularly the 
ORACLE Database Administrator's Guide, for more information 
about these two parameters. 



End of ALLY Installation Guide 
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Setting Your Terminal 



Terminal Configuration for ALLY 

This appendix contains information for configuring SVT-1220 and 
UVT-1224 terminals to communicate with ALLY. (The 
SVT-1210 terminal does not need to be set specifically to run with 
ALLY.) Only settings that apply specifically to ALLY are 
shown. See the documentation supplied with your terminal for 
more information. 

Table A-1. SVT-1220 and UVT-1224 Terminal Settings 

Category Setting 

Display 80 Columns 

Interpret Controls 
60 Hz. 

General VT200 Mode, 7-Bit Controls 

User-Defined Keys Unlocked 
User Features Unlocked 
Clear User-Defined Keys 
Numeric Keypad 
Normal Cursor Keys 
No New Line 
Multinational 
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Category 


setting 


Communications 


Transmit=9600 




Receive = Transmit 




XOFF at 64 




8 Bits, No Parity 




1 Stop Bit 




Nn I oral Frho 




Main Port Data I pads Onlv 




Disconnect 7 « Delav 




Unlimited Transmit 


Enhancements 


Main Received XOFF= Implement 




Shift User- Defined F-Keys 




VT100 F-Keys=ESC/BS/LF Only 




Space Suppression On 




Transmit Area= Screen 




Immediate Transmit 



End of Appendix A 
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Appendix B 
Configuring the U7000 Series 



Changing the File-Locking Table Size 



NOTE: This process requires you to shut down the operating 
system. Make sure that no one is using the system when you 
do this. 



Follow the steps below to change the default maximum file- 
locking table size on U7000 series systems. 

1) Log-in to the system as the root (super user). 
Type: root<Return> 

2) Access the system configuration subdirectory. 
Type: cd /usr/src/uts/machine/cf< Return > 

3) An option in the system configuration file allows you to over- 
ride the default maximum table size. To use this option, you 
first need to change the file "space. c." 

Locate the following lines in the file named "space. c." 



/* file and record locking */ 

fldafine FLOfflEE 100 /* # lock structures */ 

struct fldrinfo flddnf oK 
FUXBEC, 
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Edit the "space. c" file and change the lines shown above to 
the following: 



/* file and moard locking */ 
fcLtndaf FLCXREC 

ftdefise FLCXHEE 100 /* # lode structures */ 
fendif 

struct flddnf o flddnf o={ 
FLCXREC, 



4) Enter the following command. 
Type: 

echo "options FLCKREC= table_size" >> NCF<Return> 

Comment: Enter the estimated maximum number of file 
locks needed at your site for table_size. 

5) Make a new UNIX kernel by entering the following series of 
commands. 

Type: cat CF >> NCF< Return > 

config NCF<Return> 

make -f cf.mk<Return> 

cd ..<Return> 

cp unixX/<Return> 

Comment: Your new kernel may be called "unixX," where X 
is one of the following: "unisys," "cf," "sperry," 
or site_name. 

6) Shut down the system to single-user mode with the following 
command. 

Type: /etc/shutdown 

Comment: You are prompted for verification when the sys- 
tem shuts down. 



B-2 



UP-14221 



Appendix B 



7) Log-in to the system as the root (super user). 
Type: root<Return> 

8) Save the old UNIX kernel (in the "unix" file) by copying it 
to another file ("unix.old"). Then create a new UNIX ker- 
nel by copying your new kernel to the "unix" file. 

Type: mv unix unix.old< Return > 

mv unixX u nix < Return > 

9) Type the 'sync' command three times to flush the file system 
buffers to the disk. 

Type: sync; sync; sync;<Retum> 

10) Reboot the system. 



End of Appendix B 
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Configuring the U6000/50 

Changing the File-Locking Table Size 



NOTE: This process requires you to shut down the operating 
system. Make sure that no one is using the system when you 
do this. 

Follow the steps below to change the default maximum file- 
locking table size on the U6000/50 system. 

1) Log-in to the system as the root (super user). 
Type: root< Return > 

2) Access the system configuration subdirectory. /efc/^nctj 
Type: cd /usr/sys/build/SPC200< Return > 

3) Make a copy of the original system configuration file (dfile). 
The following statement copies the system configuration file 
to a file named "dfile.orig." 

Type: cp dfile dfile.orig< Return > 

4) Enter the following command. 

Type: echo "nf locks tablejsize" » dfile< Return > 

Comment: Enter the estimated maximum number of file 
locks needed at your site for tablejsize. 

5) Make a new UNIX kernel. 

Type: make -f unix.mk<Return> 

Response: The new kernel is placed in the file named 
"unix." 
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6) Shut down the system to single-user mode. 

Type: /etc/shutdown < Return > 

Comment: You are prompted for verification when the sys- 
tem shuts down. 

7) Log-in to the system as the root (super user) . 
Type: root<Return> 

8) Access the system configuration subdirectory. 
Type: cd /usr/sys/build/SPC200<Return> 

9) Enter the following command to copy the new kernel to the 
root directory. 

Type: cp unix /unix.new<Return> 

Response: The new kernel is copied to the root directory in 
the file named "unix. new." 

10) Save the old UNIX kernel (in the "unix" file) by copying it 
to another file (unix. old). Then create a new UNIX kernel 
by copying "unix. new" to the "unix" file. 

Type: mv unix unix.old<Return> 

cp unix.new unix< Return > 

11) Type the k sync' command three times to flush the file system 
buffers to the disk. 

Type: sync; sync; sync;< Return > 

12) Reboot the system. 

End of Appendix C 
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Appendix D 
Configuring the 115000/85,90,95 



Changing the File-Locking Table Size 



NOTE: This process requires you to shut down the operating 
system. Make sure that no one is using the system when you 
do this. 



Follow the steps below to change the default maximum file- 
locking table size on U5000/85 ,90,95 systems. 

1) Log-in to the system as the root (super user). 
Type: root<Return> 

2) Access the system configuration directory and enter the fol- 
lowing series of commands. 

Type: cd /usr/sys/cf < Retu rn > 

cp system system. old<Return> 

echo "locks tablejsize" >> 
system < Retu rn> 

Comment: Enter the estimated maximum number of file 
locks needed at your site for tablejsize. 

3) Enter the following commands to make a new UNIX kernel. 

Type: cd ..<Return> 

make -f local. mk UODE= site_name 
<Return> 

cp site_name.MMDD /<Return> 

Comment: MM is a two-digit number that specifies the 

month. DD is a two-digit number that specifies 
the day of the month. 
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4) Shut down the system to single-user mode. 

Type: /etc/shutdown<Return> 

Comment: You are prompted for verification when the sys- 
tem shuts down. 

5) Log-in to the system as the root (super user). 
Type: root<Return> 

6) Enter the following command. 

Type: In site_name.MMDD syst<Return> 

Comment: The first letter in "In" is lowercase L. MM is a 
two-digit number that specifies the month. DD is 
a two-digit number that specifies the day of the 
month. 

7) Type the k sync' command three times to flush the file system 
buffers to the disk. 

Type: sync; sync; sync;<Return> 

8) Reboot the system. 

End of Appendix D 
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Appendix E 
Configuring the U5000 30,35,50,55 



You must increase the maximum process memory space to run 
ALLY on U5000/30,35 and U5000/50,55 systems. ALLY 
requires a process memory space of at least two megabytes and 
preferably four megabytes. Depending on the number of users at 
your site, you may also need to increase the default maximum size 
of the file-locking table. 

Increasing the Process Memory Space and 
Changing the File-Locking Table Size 

Follow the steps outlined below to increase the maximum process 
memory space and reconfigure your system. These instructions 
include an optional step if you need to increase the maximum size 
of the file-locking table. See the Administrator Reference Manual 
(UP-11761) for further details. 



NOTE: This process requires you to shut down the operating 
system. Make sure that no one is using the system when you 
do this. 



1) Log-in to the system as the root (super user). 
Type: root< Return > 

2) Access the configuration subdirectory. 
Type: cd /kernel/sperry/cf< Return > 

3) Make a copy of the original configuration file. This state- 
ment copies the "5.2.cf ' file to a file named k *5.2.cf.orig." 

Type: cp 5.2.cf 5.2.cf.orig<Return> 
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4) Modify the configuration file. This statement edits the 
*'5.2.cf" file and adds the line "maxspace 4194304" in part 2. 

Type: echo "maxspace 4194304" >> 
5.2.cf< Return > 

5) Do this step only if you need to increase the maximum size of 
the file-locking table. (If you do not need to change the file- 
locking table size, skip this step and proceed with step 6.) 

Modify the file named "/usr/include.lO/sys/inode.h" by 
changing the value of "NFLOCKS" from 200 to the 
estimated maximum number of file locks needed at your site. 

6) Make a new UNIX file. 

Type: cd /kernel < Return > 
make unix<Return> 

Response: The new UNIX file is placed in 
' * kernel/sperry/un ix5 . 2 . " 

7) Enter the following command to copy the file to the root 
directory. 

Type: cp unix5.2 / 

8) Shut down the system to single-user mode. 

Type: /etc/shutdown< Return > 

Comment: You are prompted for verification when the sys- 
tem shuts down. 

9) Log-in to the system as the root (super user). 
Type: root<Return> 

10) Make a backup copy of the old UNIX file and then overwrite 
the old file with the UNIX file just created. 

Type: mv unix unix.old 

mv unix5.2 unix 
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1 1) Type the *sync' command three times to flush the file system 
buffers to the disk. 

Type: sync; sync; sync;<Return> 

12) Reboot the system. 

End of Appendix E 



UP-14221 



E-3 



Appendix F 
Files: .cshrc and .profile 

Figure F-l shows the contents of the ".cshrc" file. 



• 

# Establish cab. ivliummL far ALLY. 

# Set up search path to scan. ALLY's bin directory, 

# set ALLY'a a utfliiua ent variable ->ally<- ao ALLY knew* where things live. 
• 

# 

echo Ipath I grep -s /g/ ajet/xoer/ally/ally^JX) >k /dev/null 

If C •status — 1 ) then 

• 

# Define ALLY'S sulxuBml variable. 
« 

setenv ally /a/ally2_0O 

set path = ( $path $ally/hLn ) 

endif 
« 

# Define shorter alias for allyedLt. 
ft 

alias ae allyedit 



Figure F-1. ".cshrc" File Contents 



The ".profile" file is shown in Figure F-2. 



ally=/g/custci 
export ally 
PKD*=: . :/o/om 
H>i t PA3H 


wr/ally/ally2_f» 
rtoi^/any/any^JXD/biri-.^Affl: 






Figure F-2. ".profile" File Contents 






End of Appendix F 
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